<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      docbook-xsl-nons-1.79.2
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-2020-04-02">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 2020-04-02
      </h4>
      <h3>
        Chapter&nbsp;49.&nbsp;Extensible Markup Language (XML)
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="docbook51.html" title=
          "docbook-xml-5.1">Prev</a>
          <p>
            docbook-xml-5.1
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="itstool.html" title="itstool-2.0.6">Next</a>
          <p>
            itstool-2.0.6
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="xml.html" title=
          "Chapter&nbsp;49.&nbsp;Extensible Markup Language (XML)">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="docbook-xsl" name="docbook-xsl"></a>docbook-xsl-nons-1.79.2
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to DocBook XSL Stylesheets
        </h2>
        <p>
          The <span class="application">DocBook XSL Stylesheets</span>
          package contains XSL stylesheets. These are useful for performing
          transformations on XML DocBook files.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://github.com/docbook/xslt10-stylesheets/releases/download/release/1.79.2/docbook-xsl-nons-1.79.2.tar.bz2">
                https://github.com/docbook/xslt10-stylesheets/releases/download/release/1.79.2/docbook-xsl-nons-1.79.2.tar.bz2</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: 2666d1488d6ced1551d15f31d7ed8c38
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 22 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 58 MB (includes installing
                optional documentation)
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: less than 0.1 SBU
              </p>
            </li>
          </ul>
        </div>
        <h3>
          Additional Downloads
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Required patch: <a class="ulink" href=
                "http://www.linuxfromscratch.org/patches/blfs/svn/docbook-xsl-nons-1.79.2-stack_fix-1.patch">
                http://www.linuxfromscratch.org/patches/blfs/svn/docbook-xsl-nons-1.79.2-stack_fix-1.patch</a>
              </p>
            </li>
          </ul>
        </div>
        <div class="itemizedlist">
          <p class="title">
            <strong>Optional documentation</strong>
          </p>
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://github.com/docbook/xslt10-stylesheets/releases/download/release/1.79.2/docbook-xsl-doc-1.79.2.tar.bz2">
                https://github.com/docbook/xslt10-stylesheets/releases/download/release/1.79.2/docbook-xsl-doc-1.79.2.tar.bz2</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: 62375ca864fc198cb2b17d98209d0b8c
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 522 KB
              </p>
            </li>
          </ul>
        </div>
        <h3>
          DocBook XSL Stylesheets Dependencies
        </h3>
        <h4>
          Recommended (at runtime)
        </h4>
        <p class="recommended">
          <a class="xref" href="../general/libxml2.html" title=
          "libxml2-2.9.10">libxml2-2.9.10</a>
        </p>
        <h4>
          Optional (all used at runtime)
        </h4>
        <p class="optional">
          <a class="xref" href="../general/apache-ant.html" title=
          "apache-ant-1.10.7">apache-ant-1.10.7</a> (to produce <span class=
          "quote">&ldquo;<span class="quote">webhelp</span>&rdquo;</span>
          documents), <a class="xref" href="../general/libxslt.html" title=
          "libxslt-1.1.34">libxslt-1.1.34</a> (or any other XSLT processor),
          to process Docbook documents - the <span class=
          "application">Python2</span> modules libxml2 and libxslt can be
          used, <a class="xref" href="../general/python2.html" title=
          "Python-2.7.17">Python-2.7.17</a> (at runtime), <a class="xref"
          href="../general/ruby.html" title="Ruby-2.7.1">Ruby-2.7.1</a> (to
          utilize the <span class="quote">&ldquo;<span class=
          "quote">epub</span>&rdquo;</span> stylesheets), <a class="xref"
          href="../general/zip.html" title="Zip-3.0">Zip-3.0</a> (to produce
          <span class="quote">&ldquo;<span class=
          "quote">epub3</span>&rdquo;</span> documents), and <a class="ulink"
          href=
          "http://sourceforge.net/projects/saxon/files/saxon6/">Saxon6</a>
          and <a class="ulink" href=
          "http://xerces.apache.org/xerces2-j/">Xerces2 Java</a> (used with
          <a class="xref" href="../general/apache-ant.html" title=
          "apache-ant-1.10.7">apache-ant-1.10.7</a> to produce <span class=
          "quote">&ldquo;<span class="quote">webhelp</span>&rdquo;</span>
          documents)
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/docbook-xsl">http://wiki.linuxfromscratch.org/blfs/wiki/docbook-xsl</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of DocBook XSL Stylesheets
        </h2>
        <p>
          First, fix a problem that causes stack overflows when doing
          recursion:
        </p>
        <pre class="userinput">
<kbd class=
"command">patch -Np1 -i ../docbook-xsl-nons-1.79.2-stack_fix-1.patch</kbd>
</pre>
        <p>
          If you downloaded the optional documentation tarball, unpack it
          with the following command:
        </p>
        <pre class="userinput">
<kbd class=
"command">tar -xf ../docbook-xsl-doc-1.79.2.tar.bz2 --strip-components=1</kbd>
</pre>
        <p>
          BLFS does not install the required packages to run the test suite
          and provide meaningful results.
        </p>
        <p>
          Install <span class="application">DocBook XSL Stylesheets</span> by
          running the following commands as the <code class=
          "systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class=
"command">install -v -m755 -d /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2 &amp;&amp;

cp -v -R VERSION assembly common eclipse epub epub3 extensions fo        \
         highlighting html htmlhelp images javahelp lib manpages params  \
         profiling roundtrip slides template tests tools webhelp website \
         xhtml xhtml-1_1 xhtml5                                          \
    /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2 &amp;&amp;

ln -s VERSION /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2/VERSION.xsl &amp;&amp;

install -v -m644 -D README \
                    /usr/share/doc/docbook-xsl-nons-1.79.2/README.txt &amp;&amp;
install -v -m644    RELEASE-NOTES* NEWS* \
                    /usr/share/doc/docbook-xsl-nons-1.79.2</kbd>
</pre>
        <p>
          If you downloaded the optional documentation tarball, install the
          documentation by issuing the following command as the <code class=
          "systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class=
"command">cp -v -R doc/* /usr/share/doc/docbook-xsl-nons-1.79.2</kbd>
</pre>
      </div>
      <div class="configuration" lang="en" xml:lang="en">
        <h2 class="sect2">
          Configuring DocBook XSL Stylesheets
        </h2>
        <div class="sect3" lang="en" xml:lang="en">
          <h3 class="sect3">
            <a id="docbook-xsl-config" name="docbook-xsl-config"></a>
          </h3>
          <h4 class="title">
            <a id="docbook-xsl-config" name="docbook-xsl-config"></a>Config
            Files
          </h4>
          <p>
            <code class="filename">/etc/xml/catalog</code>
          </p>
        </div>
        <div class="sect3" lang="en" xml:lang="en">
          <h3 class="sect3"></h3>
          <h4 class="title">
            <a id="idm140006412537248" name=
            "idm140006412537248"></a>Configuration Information
          </h4>
          <div class="admon note">
            <img alt="[Note]" src="../images/note.png" />
            <h3>
              Note
            </h3>
            <p>
              If you are installing the current version of docbook-xsl-nons
              over a previous version of docbook-xsl, then remove the old
              rewrite entries in the catalog as the <code class=
              "systemitem">root</code> user:
            </p>
            <pre class="userinput">
<kbd class="command">sed -i '/rewrite/d' /etc/xml/catalog</kbd>
</pre>
          </div>
          <p>
            Create (or append) and populate the XML catalog file using the
            following commands as the <code class="systemitem">root</code>
            user:
          </p>
          <pre class="root">
<kbd class=
"command">if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi &amp;&amp;
if [ ! -f /etc/xml/catalog ]; then
    xmlcatalog --noout --create /etc/xml/catalog
fi &amp;&amp;

xmlcatalog --noout --add "rewriteSystem" \
           "https://cdn.docbook.org/release/xsl-nons/1.79.2" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &amp;&amp;

xmlcatalog --noout --add "rewriteURI" \
           "https://cdn.docbook.org/release/xsl-nons/1.79.2" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &amp;&amp;

xmlcatalog --noout --add "rewriteSystem" \
           "https://cdn.docbook.org/release/xsl-nons/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &amp;&amp;

xmlcatalog --noout --add "rewriteURI" \
           "https://cdn.docbook.org/release/xsl-nons/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &amp;&amp;

xmlcatalog --noout --add "rewriteSystem" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog &amp;&amp;

xmlcatalog --noout --add "rewriteURI" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
    /etc/xml/catalog</kbd>
</pre>
          <p>
            Occasionally, you may find the need to install other versions of
            the XSL stylesheets as some projects reference a specific
            version. One example is BLFS-6.0, which required the 1.67.2
            version. In these instances you should install any other required
            version in its own versioned directory and create catalog entries
            as follows (substitute the desired version number for <em class=
            "replaceable"><code>&lt;version&gt;</code></em>):
          </p>
          <pre class="userinput">
<kbd class="command">xmlcatalog --noout --add "rewriteSystem" \
           "http://docbook.sourceforge.net/release/xsl/<em class=
"replaceable"><code>&lt;version&gt;</code></em>" \
           "/usr/share/xml/docbook/xsl-stylesheets-<em class=
"replaceable"><code>&lt;version&gt;</code></em>" \
    /etc/xml/catalog &amp;&amp;

xmlcatalog --noout --add "rewriteURI" \
           "http://docbook.sourceforge.net/release/xsl/<em class=
"replaceable"><code>&lt;version&gt;</code></em>" \
           "/usr/share/xml/docbook/xsl-stylesheets-<em class=
"replaceable"><code>&lt;version&gt;</code></em>" \
    /etc/xml/catalog</kbd>
</pre>
        </div>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Files:</strong> <span class=
              "segbody">/usr/share/xml/docbook/xsl-stylesheets-1.79.2/*/*.xsl</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class=
              "segbody">/usr/share/xml/docbook/xsl-stylesheets-1.79.2 and
              /usr/share/doc/docbook-xsl-1.79.2</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="xsl-stylesheets" name=
                    "xsl-stylesheets"></a><span class="term"><code class=
                    "filename">XSL Stylesheets</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    are used for performing transformations on XML files.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-03-24 14:19:44 -0500
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="docbook51.html" title=
          "docbook-xml-5.1">Prev</a>
          <p>
            docbook-xml-5.1
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="itstool.html" title="itstool-2.0.6">Next</a>
          <p>
            itstool-2.0.6
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="xml.html" title=
          "Chapter&nbsp;49.&nbsp;Extensible Markup Language (XML)">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 2020-04-02">
          Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
